3D Graphics Programming with QuickDraw 3D 1.5.4

Managing Ambient Light

QuickDraw 3D provides routines that you can use to create and edit the ambient light of a view.

Q3AmbientLight_New

You can use the Q3AmbientLight_New function to create a new ambient light.



 
TQ3LightObject Q3AmbientLight_New (

                     const TQ3LightData *lightData);

lightData: A pointer to a light data structure.

DESCRIPTION

The Q3AmbientLight_New function returns, as its function result, a new ambient light having the characteristics specified by the lightData parameter.

Q3AmbientLight_GetData

You can use the Q3AmbientLight_GetData function to get the data that defines an ambient light.



 
TQ3Status Q3AmbientLight_GetData (

                     TQ3LightObject light, 

                     TQ3LightData *lightData);

light: An ambient light object.
lightData: On exit, a pointer to a light data structure.

DESCRIPTION

The Q3AmbientLight_GetData function returns, through the lightData parameter, information about the ambient light specified by the light parameter. See "Light Data Structure" for a description of a light data structure.

Q3AmbientLight_SetData

You can use the Q3AmbientLight_SetData function to set the data that defines an ambient light.



 
TQ3Status Q3AmbientLight_SetData (

                     TQ3LightObject light, 

                     const TQ3LightData *lightData);

light: An ambient light object.
lightData: A pointer to a light data structure.

DESCRIPTION

The Q3AmbientLight_SetData function sets the data associated with the ambient light specified by the light parameter to the data specified by the lightData parameter.